home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / telecomm / misc / ne1_2.lha / ne / doc / LockSer.doc < prev    next >
Encoding:
Text File  |  1993-12-08  |  2.2 KB  |  63 lines
  1.  
  2. NAME
  3.     LockSer    -     SERIAL PORT ACCESS CONTROL FOR PROGRAMS 
  4.                         WITHOUT OWNDEVUNIT-HANDLING.
  5.  
  6. SYNOPSIS
  7.         LockSer Command/A, D=Device/K, U=Unit/N, T=Time/N,
  8.                 A=Attempt/S,C=CheckSer/S,Debug/s,Help/s
  9. DESCRIPTION
  10.     LockSer is a rewritten Version of LockSerial, ditributed with
  11.     UUCP and OwnDevUnit.libraray. It is full updated for V37. 
  12.     NOW it has the ability to work with auto-detach programs.
  13.       
  14.     LockSer is used to run programs (e.g. terminal programs)
  15.     after ensuring that a given serial port and unit is free.  It
  16.     locks the port, runs the program, then unlocks the port.  The
  17.     "command" argument should NOT run things in the background,
  18.     since the port will be unlocked too early.  You can RUN the
  19.     LockSer command itself, if you wish.
  20.  
  21.     Getty or NE need not be running, but if it is it will maintain a
  22.     port lock.  When getty or NE sees the lock request it will close
  23.     the device and relinquish control to the requesting program.
  24.  
  25.     UUCico an NE runs LockSerPort()/UnLockSerPort() internally,
  26.     DO NOT RUN UUCICO OR NE WITH THIS COMMAND.
  27.  
  28. WARNING
  29.     If you want to run auto-detach programs with LockSer, you have to 
  30.         use the CheckSer-Option. But if such a program closes the serial.device
  31.         and opens it again, you'll have a problem :-)
  32.         (In this case LockSer guess that the programm has ended.)
  33.  
  34.     LockSer utilizes the OwnDevUnit.Library.  Programs that directly
  35.     support this library do not need to be run with the LockSer
  36.     program.
  37.  
  38. OPTIONS
  39.     Command     The command to run (if the command takes args,
  40.             the entire thing should be in quotes)
  41.  
  42.     D=Device    The serial device, default serial.device
  43.  
  44.     U=Unit         The unit number, default 0
  45.  
  46.         C=CheckSer    If you run an auto-detach programm, LockSer will wait
  47.             until the serial.device can be opened again, after its 
  48.             closed by the program.
  49.  
  50.         T=Time        The time in seconds LockSer waits between its tries to 
  51.                         open the device again if the CheckSer-Option is given.
  52.                         default 5 sec.
  53.  
  54.     A=Attempt    Do not lock up waiting for access if someone else
  55.             has currently got the device locked.
  56.  
  57.  
  58. EXAMPLE
  59.     1> LockSer A C "NComm:NComm"
  60.  
  61. REFERENCES
  62.     NE, Getty
  63.